Spring Webflow - Action

发表于

action-state

简单使用

该状态只执行操作，然后根据操作的结果转移到其他state。可以有多个操作，他们依次执行

1
2
3
4
5
<action-state id="moreAnswersNeeded">
	<evaluate expression="interview.moreAnswersNeeded()" />
	<transition on="yes" to="answerQuestions" />
	<transition on="no" to="finish" />
</action-state>

输出

在action-state中调用普通java对象的方法，这些方法返回的只是一般的值，但是transition标签需要Event来触发，因此web-flow会将这个普通返回值转换为Event对象，具体转换情况如下:

1
2
3
4
5
方法返回值类型			映射出来的EventId
java.lang.String		直接以字符串的值作为id
java.lang.Boolean		yes (for true), no (for false)
java.lang.Enum			the Enum name
any other type	    	success

action-state的操作

action-state可以有三种方式进行执行操作

  • 调用POJO
1
<evaluate expression="pojoAction.method(flowRequestContext)" />
1
2
3
4
5
public class PojoAction {
	public String method(RequestContext context) {
		...
	}
}
  • 实现Action接口，直接调用该action
1
<evaluate expression="customAction" />
1
2
3
4
5
public class CustomAction implements Action {
	public Event execute(RequestContext context) {
		...
	}
}
  • 实现MultiAction接口，可以定义多个一连串的方法
1
<evaluate expression="multiAction.actionMethod1" />
1
2
3
4
5
6
7
8
9
10
public class CustomMultiAction extends MultiAction {
	public Event actionMethod1(RequestContext context) {
		...
	}

	public Event actionMethod2(RequestContext context) {
		...
	}
	...
}

action的异常处理

  • POJO类action的处理方式
    发生异常时，返回相应的字符串，会映射成Event，在transition中响应就可以了，和普通方法正常返回一样
  • MultiAction的处理方式
    发生异常时，返回Event对象
1
2
3
4
5
6
7
8
9
10
11
12
13
14
public class BookingAction extends MultiAction {
	public Event makeBooking(RequestContext context) {
		   try {
			   Booking booking = (Booking) context.getFlowScope().get("booking");
			   BookingConfirmation confirmation = bookingService.make(booking);
			   context.getFlowScope().put("confirmation", confirmation);
			   return success();
		   } catch (RoomNotAvailableException e) {
			   context.getMessageContext().addMessage(new MessageBuilder().error().
				   .defaultText("No room is available at this hotel").build());
			   return error();
		   }
	}
}
  • 使用exception-handler属性，定义异常处理器

decision-state

decision-state是action-state的一种简单替代，在if/else情况时比较好用

1
2
3
<decision-state id="moreAnswersNeeded">
	<if test="interview.moreAnswersNeeded()" then="answerQuestions" else="finish" />
</decision-state>

action相关标签

  1. <on-start> flow开始时执行
  2. <on-entry> state进入时执行
  3. <on-exit> state退出时执行
  4. <on-end> flow结束时执行
  5. <on-render>view-state中使用，渲染前执行
  6. <transition> 在转移前执行

命名的action

如下展示了一个action-state下多个操作执行，为每个操作命名，第二个操作成功后进行转移操作

1
2
3
4
5
6
7
8
9
<action-state id="doTwoThings">
	<evaluate expression="service.thingOne()">
		<attribute name="name" value="thingOne" />
	</evaluate>
	<evaluate expression="service.thingTwo()">
		<attribute name="name" value="thingTwo" />
	</evaluate>
	<transition on="thingTwo.success" to="showResults" />
</action-state>

向客户端发送流信息

应用场景

客户端请求一个图片文件，此时我们需要直接操作httpresponse进行图片的响应，而不是渲染view。

解决方案

通过ExternalContext获取HttpResponse，将图片写入，然后操作ExternalContext对象记录response完成，这样web-flow就不会再渲染view，而是直接返回给浏览器

1
2
3
4
5
6
7
8
9
10
11
12
13
public class PrintBoardingPassAction extends AbstractAction {

    @Override
    protected Event doExecute(RequestContext context) throws Exception {
        HttpServletResponse response = (HttpServletResponse)context.getExternalContext().getNativeResponse();
        OutputStream os = response.getOutputStream();
        // 在这里操作os，写入流数据
        os.close();
        context.getExternalContext().recordResponseComplete();
        return success();
    }

}